CHAPTER 2 - Getting Started 02.01 The Diskettes 02.02 Loading Soft-ICE 02.02.01 Loading Without Extended Memory 02.02.02 Loading With Extended Memory 02.02.03 Configuring Soft-ICE for a Customized Installation 02.03 Unloading Soft-ICE 02.04 Reloading Soft-ICE 02.01 The Diskettes Soft-ICE comes on either a 5 1/4" diskette or a 3 1/2" diskette. When you run Soft-ICE, the name of the person that your copy of Soft-ICE is licensed to is displayed on the screen as a deterrent to software pirates. The Soft-ICE diskette is not physically copy-protected for your convenience. For our convenience, we appreciate your high regard for our licensing agreement. It is important to make a duplicate copy to be used only for backup in case the original diskette is damaged. A directory of a Soft-ICE diskette will show the following files: S-ICE.EXE is the Soft-ICE program. S-ICE.DAT is the Soft-ICE initialization file. LDR.EXE is the Soft-ICE program and symbol file loader. MSYM.EXE is the Soft-ICE symbol file creation program. EMMSETUP.EXE is a program that allows you to customize the way your system uses expanded memory. UPTIME.EXE sets the time to that of the real time clock. README.SI is a text file containing information about Soft-ICE that did not make it into this manual. SAMPLE.EXE is a short demonstration program that is used with the tutorial. SAMPLE.ASM is the assembly language source file for the demonstration program. SAMPLE.SYM is the symbol file for the demonstration program. 02.02 Loading Soft-ICE Before running Soft-ICE, copy all of the files on the distribution diskette to your hard disk. These files should be placed in a directory that is accessible through your alternate path list. S-ICE.EXE can be loaded as a device driver in CONFIG.SYS or can be run as a program from the command line. To use many of Soft-ICE's features, S- ICE.EXE must be loaded as a device driver in CONFIG.SYS. Note : If you do not have extended memory, Soft-ICE can NOT loaded as a device driver. Instead, it must be run from the DOS prompt. 02.02.01 Loading Without Extended Memory When no extended memory is present, Soft-ICE loads it at the highest memory location possible. The memory used by Soft-ICE is then 'mapped out', making it invisible to DOS programs. Since the total memory visible to DOS its programs is less after Soft-ICE loads, it is recommended that you load Soft-ICE before any TSR's or control programs. If you do not have extended memory, simply enter: S-ICE 02.02.02 Loading With Extended Memory Loading Soft-ICE with extended memory can be done in one of two ways: 1. Install S-ICE,EXE as a driver in CONFIG,SYS, This method is necessary if you will be using one the following capabilities: * Sharing memory with program that use extended memory by using ROM BIOS calls (VDISK.SYS, RAMDRIVE.SYS, HIMEM.SYS, cache programs, etc.) * Using Soft-ICE's EMM 4,0 capability, * Using Soft-ICE for symbolic or source level debugging. * Using back trace ranges. * Using Soft-ICE with other Nu-Mega products such as Magic CV. When loaded as a driver, Soft-ICE allocates a portion of extended memory for itself and its associated components so there can be no memory conflicts. S-ICE.EXE must be loaded in CONFIG.SYS before any other driver that allocates extended memory is loaded (e.g., VDISK.SYS, RAMDRIVE.SYS). Generally Soft-ICE works best if it is the first loadable device driver installed in CONFIG.SYS. For users that are new to Soft-ICE it is advisable to load Soft-ICE as the first driver in CONFIG.SYS with the following statement: device=drive:\path\S-ICE.EXE /SYM 50 Drive and path specify the d